feat(ruby): add Fuzzy Ruby Server language server support by candidosales · Pull Request #283 · zed-extensions/ruby

candidosales · 2026-04-20T03:18:00Z

Summary

Adds Fuzzy Ruby Server as a supported language server in the Ruby extension. This was requested by the Zed team after closing zed-industries/extensions#5107 — all Ruby language servers should live in this single extension rather than in separate extensions.

Fuzzy Ruby Server is a Rust binary (not a Ruby gem), so its integration intentionally bypasses the bundler/gemset installation logic used by the other language servers.

What's included

Registers fuzzy-ruby-server in extension.toml
Adds FuzzyRubyServer struct implementing the LanguageServer trait with a custom language_server_binary that:
- Honors user-configured binary path via lsp.fuzzy-ruby-server.binary.path in Zed settings (with existence validation and a clear error message if the path is invalid)
- Falls back to PATH lookup for the fuzzy binary
- Returns a descriptive install hint if the binary is not found
Extends WorktreeLike and FakeWorktree with a which() method for testability
Adds 6 unit tests covering all resolution branches (custom path, missing path, PATH lookup, not found)

Installation

Users must install the binary manually:

cargo install --git https://github.com/doompling/fuzzy_ruby_server

Or configure an explicit path in Zed settings:

{
  "lsp": {
    "fuzzy-ruby-server": {
      "binary": {
        "path": "/path/to/fuzzy"
      }
    }
  }
}

Test plan

All 57 unit tests pass (cargo test)
Unit tests cover: valid custom path, invalid custom path, PATH lookup success, PATH lookup failure
Manual: open a Ruby project in Zed with fuzzy installed and verify completions work
Manual: configure an explicit binary path and verify it is used
Manual: verify the error message when fuzzy is not installed

…erage - Updated GEM_NAME to a non-empty sentinel value to avoid silent failures in gem operations. - Refactored language_server_binary to separate binary resolution logic for custom paths and PATH lookups. - Added checks for the existence and executability of custom binary paths. - Enhanced testing coverage for language_server_binary, including tests for custom paths, PATH discovery, and error handling. - Introduced new methods in the WorktreeLike trait to facilitate testing. - Documented findings and suggestions for maintainability and reliability improvements.

candidosales · 2026-04-21T20:15:21Z

@vitallium , when you get a chance, could you review it? 🙇

vitallium · 2026-04-22T08:57:48Z

@vitallium , when you get a chance, could you review it? 🙇

Hi @candidosales. Thanks for opening this PR! I'll review this PR after May 1st because I'm on vacation at the moment.

To land it, we'll need to make sure the new LSP is disabled in the Zed settings here, otherwise it will be enabled for all users by default. Thanks!

@vitallium

…dustries#55215) ## Summary Add `!fuzzy-ruby-server` to the Ruby language servers list in the default settings so it is opt-in rather than enabled for all users by default. This is a prerequisite for merging the Fuzzy Ruby Server support in the Ruby extension: zed-extensions/ruby#283 As requested by @vitallium in the review comment: https://github.com/zed-extensions/ruby/pull/283\#issuecomment-4294888519 ## Change ```diff - "language_servers": ["solargraph", "!ruby-lsp", "!rubocop", "!sorbet", "!steep", "!kanayago", "..."], + "language_servers": ["solargraph", "!ruby-lsp", "!rubocop", "!sorbet", "!steep", "!kanayago", "!fuzzy-ruby-server", "..."], ``` Release Notes: - Disabled `fuzzy-ruby-server` by default for Ruby files. --------- Co-authored-by: Marshall Bowers <git@maxdeviant.com>

candidosales · 2026-05-01T13:54:23Z

@vitallium, the zed settings PR was merged. Could you review this one when you get a chance? Thanks

@vitallium

…dustries#55215) ## Summary Add `!fuzzy-ruby-server` to the Ruby language servers list in the default settings so it is opt-in rather than enabled for all users by default. This is a prerequisite for merging the Fuzzy Ruby Server support in the Ruby extension: zed-extensions/ruby#283 As requested by @vitallium in the review comment: https://github.com/zed-extensions/ruby/pull/283\#issuecomment-4294888519 ## Change ```diff - "language_servers": ["solargraph", "!ruby-lsp", "!rubocop", "!sorbet", "!steep", "!kanayago", "..."], + "language_servers": ["solargraph", "!ruby-lsp", "!rubocop", "!sorbet", "!steep", "!kanayago", "!fuzzy-ruby-server", "..."], ``` Release Notes: - Disabled `fuzzy-ruby-server` by default for Ruby files. --------- Co-authored-by: Marshall Bowers <git@maxdeviant.com>

…Extension

vitallium · 2026-05-08T21:46:51Z

@vitallium, the zed settings PR was merged. Could you review this one when you get a chance? Thanks

Thank you!

stgm · 2026-05-13T10:00:00Z

@vitallium @candidosales

Was it the intention that this is enabled by default and thus presents an error for all Zed users editing ruby? (that fuzzy-ruby-server is not installed)

And shouldn't this be documented at https://zed.dev/docs/languages/ruby ?

I am genuinely confused by the intent here, these are not meant as rhetorical questions.

vitallium · 2026-05-13T10:09:38Z

@vitallium @candidosales

Was it the intention that this is enabled by default and thus presents an error for all Zed users editing ruby? (that fuzzy-ruby-server is not installed)

And shouldn't this be documented at https://zed.dev/docs/languages/ruby ?

I am genuinely confused by the intent here, these are not meant as rhetorical questions.

Hi @stgm. My apologies for this issue. It wasn’t intentional. This is a sync problem on our side.

To add a new Ruby language server, it first needs to be added to the default Zed settings, but explicitly disabled. Then we need to wait for the next stable Zed release, and only after that release a new version of the Ruby extension.

Apparently, I made a mistake and missed the fact that the fuzzy server wasn’t included in a Zed release yet. I think there’s a gap in our process here. In fact, this is the second time we’ve had a similar problem, so we need to find a way to prevent issues like this in the future.

Regarding the documentation, that’s also a valid point. For example, the documentation still doesn’t mention the ‘kanayago’ LS. I do plan to update the documentation.

Sorry again, and thanks for raising these questions!

stgm · 2026-05-13T10:20:46Z

@vitallium Thank you for the explanation, that helps :-)

FWIW some context: I have no custom plain ruby language config at the moment, and Zed now uses ~~herb and~~ solargraph. I had rubocop custom configured for a while, but the default suits me fine as it is.

For me it's interesting and relevant to know (in the docs, I'm not in a hurry!) whether I would want to replace other LSPs with fuzzy-ruby-server, and why; or if it would complement those servers.

In the docs I kind of like how erb-formatter is presented as opt-in, just the setting to copy-paste. (Not really relevant but it's also very weird that the Tailwind thingy appears to be enabled by default.)

Oh and also relevant: I'm a long time Textmate user for Rails projects (switched to Zed a year ago) and have always worked very well without language servers. But some unobtrusive assistance is of course very nice. For someone like me, the omakase approach works better than having many (conflicting) options.

@vitallium

## Summary Add `!fuzzy-ruby-server` to the Ruby language servers list in the default settings so it is opt-in rather than enabled for all users by default. This is a prerequisite for merging the Fuzzy Ruby Server support in the Ruby extension: zed-extensions/ruby#283 As requested by @vitallium in the review comment: https://github.com/zed-extensions/ruby/pull/283\#issuecomment-4294888519 ## Change ```diff - "language_servers": ["solargraph", "!ruby-lsp", "!rubocop", "!sorbet", "!steep", "!kanayago", "..."], + "language_servers": ["solargraph", "!ruby-lsp", "!rubocop", "!sorbet", "!steep", "!kanayago", "!fuzzy-ruby-server", "..."], ``` Release Notes: - Disabled `fuzzy-ruby-server` by default for Ruby files. --------- Co-authored-by: Marshall Bowers <git@maxdeviant.com>

Thomascountz · 2026-06-07T18:08:10Z

I just want to document that I'm still running into this error despite having ruby-fuzzy-server disabled. I've tried uninstalling and reinstalling the Ruby extension to no avail.

Zed Log:

2026-06-07T19:54:32+02:00 ERROR [project::lsp_store] Failed to start language server "fuzzy-ruby-server": from extension "Ruby" version 0.16.13: fuzzy not found. Install with: cargo install --git https://github.com/doompling/fuzzy_ruby_server

About Zed:

Zed Preview 1.6.1 
Commit: a78aaa99af531fc07098e5fce12122404b081eeb
Version: 1.6.1+preview.301.a78aaa99af531fc07098e5fce12122404b081eeb

Default config (matches my local "Open Default Settings")

https://github.com/zed-industries/zed/blob/a78aaa99af531fc07098e5fce12122404b081eeb/assets/settings/default.json#L2284-L2294

My relevant config:

 "Ruby": {
      "language_servers": [
        "ruby-lsp",
        "standard",
        "!ruby-fuzzy-server",
        "!kanayago",
        "!rubocop",
        "!steep",
        "!sorbet",
        "!solargraph",
        "..."
      ]
    },

I have no project/local settings files.

vitallium · 2026-06-07T20:43:59Z

https://github.com/zed-industries/zed/blob/a78aaa99af531fc07098e5fce12122404b081eeb/assets/settings/default.json#L2284-L2294

Hi! I think your configuration is misconfigured:

The Fuzzy Ruby server is called fuzzy-ruby-server not ruby-fuzzy-server.
The expansion item ... works in a very specific way. A while ago, I added a special section about this to Zed doc: https://zed.dev/docs/configuring-languages?highlight=language_servers#choosing-language-servers

Let me know if that helps. Thanks!

Thomascountz · 2026-06-10T13:46:50Z

Dear @vitallium, thank you for your time helping me to read 😅
Spelling fuzzy-ruby-server correctly and removing the expansion has resolved the issue!

doompling · 2026-06-16T18:48:04Z

👋 Hello! I'm the creator of fuzzy ruby server and just have to say this is so cool! I will be releasing a redesigned version 2 of the language server soon with a lot of improvements 🫡

@vitallium

…dustries#55215) ## Summary Add `!fuzzy-ruby-server` to the Ruby language servers list in the default settings so it is opt-in rather than enabled for all users by default. This is a prerequisite for merging the Fuzzy Ruby Server support in the Ruby extension: zed-extensions/ruby#283 As requested by @vitallium in the review comment: https://github.com/zed-extensions/ruby/pull/283\#issuecomment-4294888519 ## Change ```diff - "language_servers": ["solargraph", "!ruby-lsp", "!rubocop", "!sorbet", "!steep", "!kanayago", "..."], + "language_servers": ["solargraph", "!ruby-lsp", "!rubocop", "!sorbet", "!steep", "!kanayago", "!fuzzy-ruby-server", "..."], ``` Release Notes: - Disabled `fuzzy-ruby-server` by default for Ruby files. --------- Co-authored-by: Marshall Bowers <git@maxdeviant.com>

feat(ruby): add Fuzzy Ruby Server language server support

896736a

cla-bot Bot added the cla-signed label Apr 20, 2026

candidosales added 2 commits April 19, 2026 23:34

delete

2d74d0c

candidosales marked this pull request as ready for review April 20, 2026 03:35

vitallium self-requested a review April 22, 2026 08:58

candidosales mentioned this pull request Apr 29, 2026

Disable fuzzy-ruby-server by default in Ruby language servers zed-industries/zed#55215

Merged

candidosales added 2 commits May 7, 2026 10:59

style: format code for better readability in FuzzyRubyServer and Ruby…

a33a59c

…Extension

fix: improve error handling for invalid binary path in FuzzyRubyServer

c4cec03

vitallium merged commit 7ea0d40 into zed-extensions:main May 8, 2026
5 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(ruby): add Fuzzy Ruby Server language server support - #283

feat(ruby): add Fuzzy Ruby Server language server support#283
vitallium merged 5 commits into
zed-extensions:mainfrom
candidosales:fuzzy-ruby-server

candidosales commented Apr 20, 2026 •

edited

Loading

Uh oh!

candidosales commented Apr 21, 2026

Uh oh!

vitallium commented Apr 22, 2026

Uh oh!

candidosales commented May 1, 2026

Uh oh!

vitallium commented May 8, 2026

Uh oh!

Uh oh!

stgm commented May 13, 2026

Uh oh!

vitallium commented May 13, 2026

Uh oh!

stgm commented May 13, 2026 •

edited

Loading

Uh oh!

Thomascountz commented Jun 7, 2026 •

edited

Loading

Uh oh!

vitallium commented Jun 7, 2026

Uh oh!

Thomascountz commented Jun 10, 2026

Uh oh!

doompling commented Jun 16, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Uh oh!

Conversation

candidosales commented Apr 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

What's included

Installation

Test plan

Uh oh!

candidosales commented Apr 21, 2026

Uh oh!

vitallium commented Apr 22, 2026

Uh oh!

candidosales commented May 1, 2026

Uh oh!

vitallium commented May 8, 2026

Uh oh!

Uh oh!

stgm commented May 13, 2026

Uh oh!

vitallium commented May 13, 2026

Uh oh!

stgm commented May 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Thomascountz commented Jun 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

vitallium commented Jun 7, 2026

Uh oh!

Thomascountz commented Jun 10, 2026

Uh oh!

doompling commented Jun 16, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

candidosales commented Apr 20, 2026 •

edited

Loading

stgm commented May 13, 2026 •

edited

Loading

Thomascountz commented Jun 7, 2026 •

edited

Loading